
<!DOCTYPE html>
<html class="client-nojs" lang="en" dir="ltr">
<head>
<meta charset="UTF-8"/>
<title>Hugin Control Points tab - PanoTools.org Wiki</title>




<style media="screen" type="text/css" title="Screen style sheet"> @import url(manual.css); </style>

<meta name="generator" content="MediaWiki 1.35.3"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>





<!--[if lt IE 9]><![endif]-->
</head>
<body class="mediawiki ltr sitedir-ltr mw-hide-empty-elt ns-0 ns-subject page-Hugin_Control_Points_tab rootpage-Hugin_Control_Points_tab skin-vector action-view skin-vector-legacy">


<div id="content" class="mw-body" role="main">
	<a id="top"></a>
	
	
	<h1 id="firstHeading" class="firstHeading" lang="en">Hugin Control Points tab</h1>
	<div id="bodyContent" class="mw-body-content">
		<div id="siteSub" class="noprint">From PanoTools.org Wiki</div>
		
		
		
		
		
		
		<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr"><div class="mw-parser-output"><div id="toc" class="toc" role="navigation" aria-labelledby="mw-toc-heading"><input type="checkbox" role="button" id="toctogglecheckbox" class="toctogglecheckbox" style="display:none" />
<ul>




</ul>
</div>

<h2><a name="About_Control_points"><span class="mw-headline">About Control points</span></a></h2>
<p><a href="Control_points.html" title="Control points">Control points</a> are central to Panorama Tools<a class="external" href="https://wiki.panotools.org/Panorama_Tools">[*]</a> and <a href="Hugin.html" title="Hugin">hugin</a>, because they are used to estimate the position of image position and lens parameters described above.
A control point specifies a corresponding point between two images. Using these corresponding points, the <a href="Hugin_Optimiser_tab.html" title="Hugin Optimiser tab">Optimiser tab</a> can estimate the image position and lens parameters.
It is therefore important that the control points are accurate and usually at least 3 well distributed control points should be used to estimate the image position (<a href="Yaw.html" title="Yaw">yaw</a>, <a href="Roll.html" title="Roll">roll</a> and <a href="Pitch.html" title="Pitch">pitch</a>) and maybe the <a href="Field_of_View.html" title="Field of View">HFOV</a>.
For accurate estimation of the a,b,c distortion parameters, many well distributed control points, and a large overlap (up to 50%) are required.
</p>
<h2><a name="Description"><span class="mw-headline">Description</span></a></h2>
<p>The Tab consists of two image displays and associated pull-down lists to switch images to be edited.
The bottom contains a list view where Points can be selected and some fields to edit a selected point.
Points can also be selected by clicking or dragging on them in the images.
It is possible to zoom out to show the full image.
</p><p>Entries in the pull-down lists have a coloured block indicating the average quality of the control-points between the selected photos, a short red block indicates a 'bad' alignment, whereas a larger green block indicates a 'good' alignment. No coloured block indicates that there are no control-points between the photos.
</p><p>Adding a control point works by selecting one point in the left or right image, and then clicking onto the corresponding point in the other image.
If <b>auto add</b> is not set, the points can be moved by clicking at some other place in the images.
They are added to the list of control points by pressing the <b>right mouse button</b>, the <b>a</b> key or by pushing the <b>Add</b> button.
If you press the <b>right mouse button</b> when only one point is selected, the point selection will be aborted.
<b>auto add</b> adds the control point as soon as both points have been specified.
</p><p>If the images are zoomed out (fit to window), the first click zooms to a temporary 100% view to give you the chance to refine your selection.
Note that only the second click will trigger the auto estimate.
</p><p>For good results, the <a href="Control_points.html" title="Control points">control points</a> should be as accurate as possible. However, it is often tedious to select a particular point exactly, and it may be helpful to use the <b>arrow keys</b> (<i>left</i>, <i>right</i>, <i>up</i>, and <i>down</i>) to nudge the selection point in various directions pixel-by-pixel (users of X11 may need to ensure that a particular image pane has the focus by placing the mouse cursor within its bounds). Once a point pair has been roughly selected, the <b>fine tune</b> function of <a href="Hugin.html" title="Hugin">hugin</a> can be used to estimate the corresponding point up to one tenth of a pixel.
The keyboard short cut for the <b>fine tune</b> function is the <b>f</b> key.
Fine tune only search in a small neighbourhood of the currently selected points.
The size of this neighbourhood can be controlled by opening the <a href="Hugin_Preferences.html" title="Hugin Preferences">Preferences dialog</a> and setting the <b>Local area search width</b>.
</p><p>Note that the fine tune function estimates the translation of the patch around the point selected in the other image with respect to the current image.
This works well if the rotation between the images is small and narrow angle lenses have been used.
If wide angle or <a href="Fisheye_Projection.html" title="Fisheye Projection">Fisheye Projection</a> images are used, rotation search should be activated in the <a href="Hugin_Preferences.html" title="Hugin Preferences">Preferences dialog</a>.
Then <a href="Hugin.html" title="Hugin">hugin</a> also searches for rotated occurrences of the patch around the selected point.
</p><p>The image can be scrolled by pressing the <b>middle mouse button</b> or the <b>CTRL</b> key while moving the mouse.
If the <b>shift</b> key is pressed instead, both images will be scrolled.
This is very useful if <a href="Control_points.html" title="Control points">control points</a> are set using the 100% zoom level.
</p><p>Control point creation is also influenced by the following check boxes:
</p>
<ul><li><b>auto fine tune</b> <a href="Hugin.html" title="Hugin">hugin</a> helps you to find the second point by looking for it in a search region (shown by a rectangle around the cursor). This might not always work, but usually is reliable, if the image distortions are not too big. Try and play with it.</li>
<li><b>auto add</b> A control point is automatically added when both points are known. You won't have time to refine the selection before adding the point.</li>
<li><b>auto estimate</b> Tries to estimate the position of the second point by estimating the rotation between the two images.</li></ul>
<p>All these flags can be combined. I typically use <b>auto fine tune</b> and <b>auto estimate</b> at the same time.
Then <a href="Hugin.html" title="Hugin">hugin</a> usually automatically selects the second point correctly, at least for normal, <a href="Rectilinear_Projection.html" title="Rectilinear Projection">Rectilinear Projection</a> images that are not rotated too much.
</p><p><a href="Hugin.html" title="Hugin">hugin</a> also includes an experimental <a href="Control_points.html" title="Control points">control points</a> creation algorithm.
It can be invoked by pressing the <b>g</b> key. Corners in the currently selected image are detected, and corresponding control points are set based on the current relative positions of the two images.  The images need to be approximately aligned already for this to be useful. Note that these points then need to be aligned by eye, with the <b>Fine-tune</b> button or with the <b>Fine-tune all Points</b> function in the Edit menu of the <a href="Panorama_Editor_window.html" class="mw-redirect" title="Panorama Editor window">Panorama editor</a>.
</p>
<h2><a name="Control_point_modes"><span class="mw-headline">Control point modes</span></a></h2>
<p>Use the <b>mode</b> pull down menu to change the type of an existing pair of <a href="Control_points.html" title="Control points">control points</a>.
</p>
<h3><a name="normal_control_points"><span class="mw-headline">normal control points</span></a></h3>
<p>The <b>normal</b> control point mode is used to align pairs of overlapping photos by matching
identical features in both photos.
</p>
<h3><a name="vertical_line_and_horizontal_line_control_points"><span class="mw-headline">vertical line and horizontal line control points</span></a></h3>
<p>Pairs of <a href="Vertical_control_points.html" title="Vertical control points">vertical control points</a> and <a href="Horizontal_control_points.html" title="Horizontal control points">horizontal control points</a> are different from
<b>normal</b> control points since they are used to align input images to particular alignments
in the output panorama rather than simply stitching images together.
</p><p>Select two points along a feature that you want to be aligned vertically or horizontally in
the final panorama. If these are in the same photo, <a href="Hugin.html" title="Hugin">hugin</a> will usually detect that you are
trying to create <i>horizontal</i> or <i>vertical</i> control points and set the mode appropriately,
if they are in different photos then you will need to set the mode manually.  To put two control points in the same image, select that image in both the left and right viewing panes.
</p><p>To manually create <a href="Vertical_control_points.html" title="Vertical control points">vertical control points</a> or <a href="Horizontal_control_points.html" title="Horizontal control points">horizontal control points</a>, 
</p>
<ol><li>Click on one image to create a control point, and put it at one end of the line (eg, the top of the line or the left hand end of the line).</li>
<li>Create a point in the other image, but don't put it in the location that corresponds to the first control point.  Instead, put it at the other end of the line (eg, the bottom of the line, or its right hand end).</li>
<li>Click "Add" to add the pair of control points.</li>
<li>In the list of control points, select the pair that you just created, and use the <b>mode</b> pull down menu to select either "Horizontal Line" or "Vertical Line".</li></ol>
<p>If the same image is shown on both side, vertical and horizontal control points can
be added by dragging a line with pressed alt key. The line is automatically added, the <b>auto add</b> option is ignored in this case.
</p><p>Typically <i>horizontal</i> and <i>vertical</i> points are used either to level a spherical panorama<a class="external" href="https://wiki.panotools.org/Leveling_a_Finished_Panorama">[*]</a>
or to <a href="Perspective_correction.html" title="Perspective correction">correct perspective</a>.
</p>
<h3><a name="Straight_line_control_points"><span class="mw-headline">Straight line control points</span></a></h3>
<p>Adding <a href="Straight_line_control_points.html" title="Straight line control points">straight line control points</a> is basically the same as
creating <b>horizontal control points</b> and <b>vertical control points</b>, except that you
need more than just one pair to make up a straight line.
</p><p>Create a pair of points in the <b>hugin Control Points tab</b>, then pick
<b>Add new line</b> in the <b>mode</b> pull-down.  This first line will be called
<b>Line 3</b>, you can assign more pairs of points to it using the same
<b>mode</b> pull-down.
</p>
<h2><a name="Keyboard_shortcuts"><span class="mw-headline">Keyboard shortcuts</span></a></h2>
<p>Here is a summary of the keyboard shortcuts available in the Control Point tab:
</p><p>Key 	Function
</p>
<ul><li><b>a</b> 	add a new point that has been selected in both images, and the <b>auto add</b> is switched off.</li>
<li><b>f</b> 	fine tune currently selected control point pair. Same as the <b>Fine Tune</b> button</li>
<li><b>g</b> 	experimental control point generation algorithm.</li>
<li><b>Del</b> 	Remove currently selected control point.</li>
<li><b>0</b> 	Zoom out to full view.</li>
<li><b>1</b> 	100% view.</li>
<li><b>2</b>       200% view.</li>
<li><b>arrow keys</b> nudge a selection point or selected control point around pixel-by-pixel.</li>
<li><b>shift + arrow keys</b> scroll both images at the same time.</li>
<li><b>Ctrl + left arrow</b> and <b>Ctrl + right arrow</b> switch to the next pair of photos.</li></ul>
<p>Mouse function 	Function
</p>
<ul><li><b>control key + mouse movement</b> 	Scroll image under cursor</li>
<li><b>shift key + mouse movement</b> 	Scroll both images</li>
<li><b>left button</b> 	Use left mouse button to select new points or drag existing points.</li>
<li><b>right mouse button</b> 	Add control point, if <b>auto add</b> is switched off</li>
<li><b>middle mouse button</b> 	Scroll image under cursor</li>
<li><b>shift key + middle mouse button</b> 	Scroll both images</li>
<li><b>control key + right mouse button</b> 	Remove control points in selected rectangle</li>
<li><b>alt key + drag left mouse button</b>        Add line control point (only if the same image is displayed on both sides)</li></ul>
<p><br />
</p><p>On <b>Mac OS</b> use the command key instead of the control key.
</p>

<!--
Transclusion expansion time report (%,ms,calls,template)
100.00%    0.000      1 -total
-->


</div></div><div class="printfooter">Retrieved from "<a dir="ltr" href="https://wiki.panotools.org/index.php?title=Hugin_Control_Points_tab&amp;oldid=15763">https://wiki.panotools.org/index.php?title=Hugin_Control_Points_tab&amp;oldid=15763</a>"</div>
		</div></div></body></html>